System.Collections.ObjectModel.KeyedCollection<TKey,TItem>.ChangeItemKey-Methode

Dieser Artikel enthält ergänzende Hinweise zur Referenzdokumentation für diese API.

Die ChangeItemKey(TItem, TKey) Methode ändert den eingebetteten itemSchlüssel nicht; er ersetzt einfach den im Nachschlagewörterbuch gespeicherten Schlüssel. Daher können Sie mit dem von newKey zurückgegebenen Schlüssel nicht auf item zugreifen, wenn der Schlüssel in item anders ist als GetKeyForItem.

Diese Methode tut nichts, wenn das KeyedCollection<TKey,TItem> Suchwörterbuch nicht verfügbar ist.

Jeder Schlüssel in einem KeyedCollection<TKey,TItem> muss eindeutig sein. Ein Schlüssel kann nicht sein null.

Diese Methode ist ein O(1)-Vorgang.

Hinweise für Implementierer

Bevor Sie den in ein Element eingebetteten Schlüssel ändern, müssen Sie diese Methode aufrufen, um den Schlüssel im Nachschlagewörterbuch zu aktualisieren. Wenn der Schwellenwert für die Wörterbucherstellung -1 ist, ist das Aufrufen dieser Methode nicht erforderlich.

Machen Sie die ChangeItemKey Methode nicht als öffentliche Methode einer abgeleiteten Klasse verfügbar. Der Missbrauch dieser Methode führt dazu, dass das Lookup-Wörterbuch nicht mehr mit den Objektschlüsseln synchronisiert ist. Wenn Sie beispielsweise zuerst den Schlüssel auf null festlegen und ihn dann auf einen anderen Wert setzen, werden dem Nachschlagewörterbuch mehrere Schlüssel für ein Element hinzugefügt. Diese Methode intern verfügbar machen, um veränderbare Elementschlüssel zuzulassen: Wenn sich der Schlüssel für ein Element ändert, wird diese Methode verwendet, um den Schlüssel im Nachschlagewörterbuch zu ändern.